Skip to content

Conversation

@jsquyres
Copy link
Member

@jsquyres jsquyres commented Apr 25, 2016

This is a proposal for reformatting the AUTHORS file. The intent is as follows:

  • Several of us have committed under multiple different email addresses. We need to list then all.
  • The organization acronyms were out of date with the list at the bottom (i.e., there were some acronyms that weren't in the legend at the bottom)

What do people think of the new format? I'm a little concerned about the people who have gone through multiple organizations, and therefore have super-long text lines for their affiliation, e.g., Josh Hursey: https://github.com/open-mpi/ompi/pull/1581/files#diff-3d350169560e75d0cf9fc8e3574a3639R159

Signed-off-by: Jeff Squyres jsquyres@cisco.com

@jsquyres jsquyres added the RFC label Apr 25, 2016
@bosilca
Copy link
Member

bosilca commented Apr 25, 2016

Multiline file are not easy to read/parse. Why not starting with the constant part (the name), followed by the current email address, and then all the institutions in order (current first). We can use a traditional CSV format (https://tools.ietf.org/html/rfc4180).

AUTHORS Outdated
Rainer Keller, High Performance Computing Center, Stuttgart, Oak Ridge National Laboratory
rainer.keller@hft-stuttgart.de
rainer.keller@hlrs.de
Ralph Castain, Los Alamos National Laboratory, Cisco, Intel
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should add Greenplum to list

@jsquyres jsquyres force-pushed the pr/AUTHORS-update branch from c3aaa31 to 136189c Compare April 26, 2016 10:46
@jsquyres
Copy link
Member Author

@rhc54 Done
@kmroz Done
@jjhursey Done
@derbeyn Your email address change will be reflected in your future commits. Your past commits were all done with the old @bull.net addresses, and will always be listed as such in the Git history (i.e., we can't change Git history in the public repo).

@bosilca Is machine-parsable a requirement?

FWIW, here's the rationale for the initial format I submitted:

  • List all the email addresses (so that every commit is accounted for)
  • As is obvious by the list, we've had people switch between organizations multiple times
  • I did not try to match email address with organization (that's complicated for some people)
  • It seemed desirable to put the name and list of organizations on the same line. But this has an undesirable side-effect for people who have been to a lot of organizations (e.g., Josh Hursey had multiple internships, which made a super-long list of organizations)
  • I reasoned that indenting would make the file "machine-parsable enough", if that was actually a requirement.

How about fully embracing the multi-line strategy with something like this:

Name: Josh Hursey
Org: Indiana University
Org: Oak Ridge National Laboratory
Org: Los Alamos National Laboratory
Org: Lawrence Berkeley National Laboratory
Org: University of Wisconsin-La Crosse
Org: IBM
Email: jhursey@us.ibm.com
Email: jjhursey@open-mpi.org

Name: Joshua Ladd
Org: Mellanox
Email: jladd.mlnx@gmail.com
Email: joshual@mellanox.com

(note the blank line between people)

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

Doing a quick grep for authors (git log | grep "^Author:" | grep -v '\-\-quiet' | sed 's/^Author://' | sort -u) gives the following list. It would be nice if we can parse the content of AUTHORS and match it with the git knowledge to make sure we account for everyone.

 Abhishek Kulkarni <adkulkar@cs.indiana.edu>
 Adrian Knoth <adi@minet.uni-jena.de>
 Adrian Reber <adrian@lisas.de>
 Alejandro Vilches <alejandro.vilches@intel.com>
 Aleksey Senin <alekseys@mellanox.com>
 Alex Margolin <alex.margolin@mail.huji.ac.il>
 Alex Mikheev <alexm@mellanox.com>
 Alina Sklarevich <alinas@mellanox.com>
 Anandhi S Jayakumar <anandhi.s.jayakumar@intel.com>
 Andreas Knüpfer <andreas.knuepfer@tu-dresden.de>
 Andrew Friedley <afriedle-intel@users.noreply.github.com>
 Andrew Friedley <afriedle@osl.iu.edu>
 Andrew Friedley <andrew.friedley@intel.com>
 Andrew Lumsdaine <lums@cs.indiana.edu>
 Anya Tatashina <anya.tatashina@sun.com>
 Artem Polyakov <artpol84@gmail.com>
 Aurelien Bouteiller <bouteill@icl.utk.edu>
 Aurelien Bouteiller <darter4.nics.utk.edu>
 Aurélien Bouteiller <bouteill@icl.utk.edu>
 Avneesh Pant <avneesh.pant@qlogic.com>
 Bert Wesarg <bert.wesarg@tu-dresden.de>
 Bill D'Amico <bdamico@cisco.com>
 Brad Benton <brad.benton@us.ibm.com>
 Brad Penoff <penoff@cs.ubc.ca>
 Brian Barrett <brbarret@open-mpi.org>
 Brice Goglin <Brice.Goglin@inria.fr>
 Camille Coti <ccoti@icl.utk.edu>
 Christian Bell <christian.bell@qlogic.com>
 Christoph Niethammer <niethammer@hlrs.de>
 Christopher Yeoh <cyeoh@au1.ibm.com>
 Craig E Rasmussen <rasmus@cas.uoregon.edu>
 Dan Lacher <dan.lacher@sun.com>
 Dave Goodell <davidjgoodell@gmail.com>
 Dave Goodell <dgoodell@cisco.com>
 David Daniel <ddd@lanl.gov>
 Denis Dimick <dgdimick@lnal.gov>
 Devendar Bureddy <bureddy@users.noreply.github.com>
 Devendar Bureddy <devendar@mellanox.com>
 Dimitar Pashov <d.pashov@gmail.com>
 Donald Kerr <donald.kerr@oracle.com>
 Doron Shoham <dorons@mellanox.com>
 Edagr Gabriel <gabriel@Peggys-MacBook-Air.local>
 Edgar Gabriel <edgargabriel@users.noreply.github.com>
 Edgar Gabriel <gabriel@cs.uh.edu>
 Elena <elena.elkina@itseez.com>
 Ethan Mallove <ethan.mallove@oracle.com>
 Eugene Loh <eugene.loh@oracle.com>
 Federico Reghenzani <federico1.reghenzani@mail.polimi.it>
 Francois WELLENREITER <francois.wellenreiter@atos.net>
 Francois WELLENREITER <wellen@free.fr>
 Gabriel Pichot <gabriel.pichot@gmail.com>
 Galen Shipman <gshipman@lanl.gov>
 Geoffrey Paulsen <gpaulsen@us.ibm.com>
 George Bosilca <bosilca@eecs.utk.edu>
 George Bosilca <bosilca@icl.utk.edu>
 Gilles Gouaillardet <ggouaillardet@users.noreply.github.com>
 Gilles Gouaillardet <gilles.gouaillardet@iferc.org>
 Gilles Gouaillardet <gilles@rist.or.jp>
 Ginger Young <gingery@lanl.gov>
 Gleb Natapov <gleb@voltaire.com>
 Gopal Santhanaraman <santhana@osu.edu>
 Graham Fagg <gef@icl.utk.edu>
 Greg Koenig <koenig@acm.org>
 Greg Watson <gwatson@lanl.gov>
 Guillaume Papauré <guillaume.papaure@bull.net>
 Hadi Montakhabi <hmontakhabi@uh.edu>
 Howard Pritchard <howardp@lanl.gov>
 Howard Pritchard <hppritcha@gmail.com>
 Howard Pritchard <hppritcha@users.noreply.github.com>
 Iain Bason <iain.bason@oracle.com>
 Igor Ivanov <Igor.Ivanov@itseez.com>
 Igor Ivanov <igor.ivanov.va@gmail.com>
 Igor Usarov <igoru@mellanox.com>
 Jeff Squyres <jeff@squyres.com>
 Jeff Squyres <jsquyres@cisco.com>
 Jeff Squyres <jsquyres@users.noreply.github.com>
 Jelena Pjesivac-Grbovic <pjesa@icl.iu.edu>
 Jithin Jose <jithin.jose@intel.com>
 John Westlund <john.a.westlund@intel.com>
 Jon Mason <jdmason@opengridcomputing.com>
 Jose Roman <jroman@dsic.upv.es>
 Josh Hursey <jjhursey@open-mpi.org>
 Joshua Hursey <jhursey@us.ibm.com>
 Joshua Hursey <jjhursey@open-mpi.org>
 Joshua Ladd <jladd.mlnx@gmail.com>
 Joshua Ladd <joshual@mellanox.com>
 KAWASHIMA Takahiro <t-kawashima@jp.fujitsu.com>
 Karen Norteman <karen.norteman@sun.com>
 Karl Mroz <mroz.karol@gmail.com>
 Karol Mroz <mroz.karol@gmail.com>
 Kenneth Matney <matneykdsr@ornl.gov>
 Laura Casswell <lcasswell@lanl.gov>
 Lenny Verkhovsky <lennyb@voltaire.com>
 Leobardo Ruiz Rountree <lruizrountree@gmail.com>
 Li-Ta Lo <ollie@lanl.gov>
 MPI Team <mpiteam@open-mpi.org>
 Mangala Jyothi Bhaskar <mjbhaskar@crill.cs.uh.edu>
 Mangala Jyothi Bhaskar <mjbhaskar@salmon.cs.uh.edu>
 Mangala Jyothi Bhaskar <mjbhaskar@uh.edu>
 Manjunath Gorentla Venkata <manjugv@ornl.gov>
 Mark Santcroos <m.a.santcroos@amc.uva.nl>
 Mark Santcroos <mas781@scarletmail.rutgers.edu>
 Mark Taylor <mt@lanl.gov>
 Matias A Cabral <matias.a.cabral@intel.com>
 Matias Cabral <matcabral@users.noreply.github.com>
 Matthias Jurenz <matthias.jurenz@tu-dresden.de>
 Maximilien Levesque <maximilien.levesque@gmail.com>
 Mike Dubman <miked@mellanox.com>
 Mitch Sukalski <mwsukal@ca.sandia.gov>
 Mohamad Chaarawi <mschaara@cs.uh.edu>
 Nadezhda Kogteva - nadezhda.kogteva@itseez.com <nadezhda@mngx-orion-01.dmz.e2e.mlnx>
 Nadezhda Kogteva <nadezhda.kogteva@itseez.com>
 Nadia Derbey <Nadia.Derbey@bull.net>
 Nathan Hjelm <hjelmn@cs.unm.edu>
 Nathan Hjelm <hjelmn@lanl.gov>
 Nathan Hjelm <hjelmn@me.com>
 Nathaniel Graham <ngraham@lanl.gov>
 Nathaniel Graham <nrgraham23@gmail.com>
 Nick Papior Andersen <nickpapior@gmail.com>
 No Author <no-author@open-mpi.org>
 Nysal Jan <jnysal@in.ibm.com>
 Nysal Jan K A <jnysal@gmail.com>
 Nysal Jan K.A <jnysal@in.ibm.com>
 Orion Poplawski <orion@cora.nwra.com>
 Oscar Vega-Gisbert <ovega@dsic.upv.es>
 Pak Lui <pak.lui@sun.com>
 Patrick Geoffray <patrick@myri.com>
 Pavel Shamis (Pasha) <shamisp@ornl.gov>
 Pavel Shamis / Pasha <shamisp@users.noreply.github.com>
 Pavel Shamis <shamisp@ornl.gov>
 Pierre Lemarinier <lemarini@icl.utk.edu>
 Piotr Lesnicki <piotr.lesnicki@ext.bull.net>
 Prabhanjan Kambadur <pkambadu@osl.iu.edu>
 Raghavendra Pendyala <raghavendra.p.pendyala@intel.com>
 Rainer Keller <rainer.keller@hft-stuttgart.de>
 Rainer Keller <rainer.keller@hlrs.de>
 Ralph Castain <rhc@odin.cs.indiana.edu>
 Ralph Castain <rhc@open-mpi.org>
 Reese Faucette <rfaucett@cisco.com>
 Rich Graham <richardg@mellanox.com>
 Rob Awles <rta@lanl.gov>
 Rob Latham <robl@mcs.anl.gov>
 Rolf vandeVaart <rvandevaart@nvidia.com>
 Ron Brightwell <rbbrigh@sandia.gov>
 Ryan Grant <regrant233@gmail.com>
 Ryan Grant <regrant@sandia.gov>
 Sami Ayyorgun <sami@lanl.gov>
 Samuel Gutierrez <samuel@lanl.gov>
 Sayantan Sur <surs@osu.edu>
 Sharon Melamed <sharonm@voltaire.com>
 Shiqing Fan <shiqing@hlrs.de>
 Steve Wise <swise@opengridcomputing.com>
 Sushant Sharma <sushant@lanl.gov>
 Sven Stork <stork@hlrs.de>
 Swen Boehm <sboehm@ornl.gov>
 Sylvain Jeaugey <sjeaugey@nvidia.com>
 Sylvain Jeaugey <sylvain.jeaugey@bull.net>
 Teng Lin <teng.lin@gmail.com>
 Terry Dontje <terry.dontje@oracle.com>
 Thananon Patinyasakdikul <tpatinya@utk.edu>
 Thara Angskun <angskun@cs.utk.edu>
 Thomas Herault <herault@icl.utk.edu>
 Tim Mattox <timothy.mattox@engilitycorp.com>
 Tim Mattox <tmattox@gmail.com>
 Tim Prins <tprins@lanl.gov>
 Tim Woodall <twoodall@lanl.gov>
 Todd Kordenbrock <thkgcode@gmail.com>
 Todd Kordenbrock <thkorde@sandia.gov>
 Todd Kordenbrock <tkordenbrock@users.noreply.github.com>
 Tom Naughton <naughtont@ornl.gov>
 Tomislav Janjusic <tomislavj@mngx-apl-01.mtl.labs.mlnx>
 Torsten Hoefler <htor@osl.iu.edu>
 Valentin Petrov <valentinp@mellanox.com>
 Vasily Filipov <vasily@mellanox.com>
 Vishal Sahay <vsahay@osl.iu.edu>
 Vishwanath Venkatesan <vvenkates@gmail.com>
 Weikuan Yu <yuw@lanl.gov>
 Wesley Bland <wbland@icl.utk.edu>
 William Throwe <wtt6@cornell.edu>
 Yael Dayan <yaeld@mellanox.com>
 Yevgeny Kliteynik <kliteyn@mellanox.co.il>
 Yohann Burette <yburette@users.noreply.github.com>
 Yohann Burette <yohann.burette@intel.com>
 Yossi <yosefe@mellanox.com>
 Yossi Etigin <yosefe@mellanox.com>
 Yossi Itigin <yosefe@mellanox.com>
 Zhi Ming Wang <wangzm@cn.ibm.com>
 Zhiming Wang <wangzm@cn.ibm.com>
 adrianreber <adrian@lisas.de>
 annu13 <annapurna.dasari@intel.com>
 bosilca <bosilca@users.noreply.github.com>
 bureddy <bureddy@users.noreply.github.com>
 elenash <elena.elkina89@gmail.com>
 hpp <howardp@lanl.gov>
 igor-ivanov <igor.ivanov.va@gmail.com>
 igor.ivanov@itseez.com <igor.ivanov@itseez.com>
 lrrajesh <l.r.rajeshnarayanan@intel.com>
 matcabral <matias.a.cabral@intel.com>
 mjbhaskar <mjbhaskar@uh.edu>
 rhc54 <rhc@open-mpi.org>
 rolfv <rvandevaart@nvidia.com>
 yohann <yohann.burette@intel.com>
 yosefe <yosefe@mellanox.com>

pak.lui@sun.com
Patrick Geoffray, Myricom
patrick@myri.com
Pavel Shamis, Mellanox, Oak Ridge National Laboratory
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add ARM to the list

@jsquyres
Copy link
Member Author

@bosilca Yes, I used git log --format="%an %ae" | sort | uniq to manually create the list that is on this PR. I think we would definitely have some kind of cron script (once a day?) that looks for new commits that are not listed in AUTHORS (and mails a warning if it finds some).

@jsquyres
Copy link
Member Author

@bosilca Forgot to mention: the output from the git commits sometimes reveals that people spell their names differently in different commits. So even the git knowledge is... imprecise. 😢

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

Yes, I noticed that. I wonder what are the email address on users.noreply.github.com ? Online modifications ?

@jsquyres
Copy link
Member Author

It looks like that comes if you do a PR merge and you haven't set a primary email address on your github account properly.

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

After investigation it appears that if you protect your email address in your github profile, your UI actions automatically get associated with an users.noreply.github.com email.

@jsquyres
Copy link
Member Author

@bosilca Do you have something we can cite/link to about that? If so, I can add it to the github startup pages on our wiki (e.g., for new OMPI devs). Thanks!

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

Empirical evidence ;) And github doc

@jsquyres
Copy link
Member Author

@goodell
Copy link
Member

goodell commented May 2, 2016

On a related note, it looks like the .mailmap file could use an update. After the official transition to git, we no longer have any addresses that contain open-mpi-git-mirror.example.com in them. This file should probably be autogenerated from whatever AUTHORS file we end up with, possibly with a static bit of text glued on the top to handle things like Jeff's --quiet <--quiet> .gitconfig snaggle. The main value of generating such a file is to help unify the "I clicked the Merge PR button" address with whatever address is used when running git commit.

@ibm-ompi
Copy link

Test passed.

@jsquyres jsquyres force-pushed the pr/AUTHORS-update branch from f86f5b5 to 02af4cf Compare May 28, 2016 13:53
jsquyres added 2 commits May 31, 2016 19:18
Signed-off-by: Jeff Squyres <jsquyres@cisco.com>
Remove all @open-mpi-git-mirror entries; those are no longer necessary
since the official migration to Git/Github.

Add aliases for @users.noreply.github.com addresses.

Add fixes for what look like accidental name mispellings /
common-name-isms.

Signed-off-by: Jeff Squyres <jsquyres@cisco.com>
@jsquyres jsquyres force-pushed the pr/AUTHORS-update branch from 02af4cf to 36f6531 Compare May 31, 2016 23:18
@jsquyres
Copy link
Member Author

@goodell Good points; I updated the .mailmap file.

@ggouaillardet
Copy link
Contributor

@jsquyres my previous email (gilles.gouaillardet@iferc.org) is not listed here, i do not use it any more, but should it be listed anyway ?

@jsquyres
Copy link
Member Author

jsquyres commented Jun 4, 2016

@jsquyres
Copy link
Member Author

jsquyres commented Jun 4, 2016

@ggouaillardet I'm sorry; I misunderstood your question. We're listing all the email addresses that appear in the output of git log -- i.e., if you see email address X, it maps to person Y. Even if that email address doesn't exist/work any more.

@jsquyres jsquyres merged commit c0fc0d1 into open-mpi:master Jun 4, 2016
@jsquyres jsquyres deleted the pr/AUTHORS-update branch June 4, 2016 01:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants